home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
X11
/
xpostit.z
/
xpostit
Wrap
Text File
|
1998-10-30
|
17KB
|
397 lines
XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111)))) XXXX11111111RRRR5555 ((((SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111))))
NNNNAAAAMMMMEEEE
xpostit - X window system Post-it notes
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
xxxxppppoooossssttttiiiitttt [ -_t_o_o_l_k_i_t_o_p_t_i_o_n_s ... ] [ -_o_p_t_i_o_n_s ... ]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_X_p_o_s_t_i_t provides a mechanism for manipulating on-screen
Post-itr notes. All six sizes of Post-it notes may be
displayed, edited, and saved to disk files. In addition,
any on-screen note may be resized to any arbitrary size
either when it is created or at a later time.
When _x_p_o_s_t_i_t is first invoked, it creates a small window
with a plaid background. This is the control window for
_x_p_o_s_t_i_t. Additionally, if any notes were stored in the save
directory (see below), these will be placed on the screen at
their last locations. Each Post-it note, when created,
makes another window on the screen. _X_p_o_s_t_i_t is controlled
using the mouse buttons and a menu. The Post-it notes are
controlled using buttons (Command widgets).
OOOOPPPPTTTTIIIIOOOONNNNSSSS
_X_p_o_s_t_i_t accepts all of the standard X Toolkit command line
options along with the additional options listed below.
----bbbbssss _n_u_m_b_e_r
Specifies the size of the character buffer in which
to save each Post-it note. A note may not contain
more than this number of characters, including
newlines. The default is 1024.
----ddddiiiirrrr _p_a_t_h
Specifies the path name of the directory in which to
store saved Post-it notes. If _p_a_t_h begins with a
`/' it is taken as-is; if it does not begin with a
`/', the path is taken relative to the home
directory. The named directory must already exist
if notes are to be saved in it. The default is
._p_o_s_t_i_t_n_o_t_e_s.
----ssssbbbb Enables scroll-bars. If specified, a scroll bar
will be attached to each Post-it note.
----ssssvvvv Enables save-on-exit. When specified, this option
tells _x_p_o_s_t_i_t to save all Post-it notes to disk
files when exiting. If not specified, notes will
only be saved to disk files when saved manually by
the user.
WWWWIIIIDDDDGGGGEEEETTTT UUUUSSSSAAAAGGGGEEEE
_X_p_o_s_t_i_t uses several widget types to construct the objects
Page 1 (printed 4/30/98)
XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111)))) XXXX11111111RRRR5555 ((((SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111))))
it uses.
The control window is a Plaid widget called ``Plaid''.
The menu is a pop-up shell called ``Menu'' containing a
SimpleMenu widget.
Each Post-it note is a pop-up shell called ``PostItNote'',
containing a Form widget called ``Note'' which contains a
Text widget called ``NoteText'', and four Command widgets
called ``Save'', ``Erase'', ``Destroy'', and ``Title''.
The confirmation box is a pop-up shell called ``Confirm'',
containing a Form widget called ``Buttons'' which contains
two Command widgets called ``Confirm'' and ``Cancel''. The
title-change box is a pop-up shell called ``Title'',
containing a Dialog widget called ``Dialog''.
RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
_X_p_o_s_t_i_t understands all of the core X Toolkit resource names
and classes as well as those listed below, which are all of
class XXXXPPPPoooossssttttiiiitttt.
....bbbbuuuuffffSSSSiiiizzzzeeee
Specifies the size of the character buffer used to
store a Post-it note. The default is 1024.
....nnnnooootttteeeeDDDDiiiirrrr
Specifies the path name of the directory in which to
store saved notes. The default is ._p_o_s_t_i_t_n_o_t_e_s.
....ssssaaaavvvveeeeNNNNooootttteeeessss
Controls the state of the save-on-exit option. The
default is ffffaaaallllsssseeee.
....ssssccccrrrroooollllllllBBBBaaaarrrr
Controls placing scroll bars on Post-it notes. The
default is ffffaaaallllsssseeee.
AAAACCCCTTTTIIIIOOOONNNNSSSS
It is possible to rebind the mouse buttons in the Plaid
widget to perform different functions by changing the
widget's translations. The _r_a_i_s_e() action, normally bound
to the left mouse button, raises all notes. The _l_o_w_e_r()
action, normally bound to the middle mouse button, lowers
all notes. The _s_h_o_w() action, normally bound to the middle
mouse button with the CTRL key, maps all unmapped notes.
The _h_i_d_e() action, normally bound to the left mouse button
with the CTRL key, unmaps all notes on the screen. The menu
raising function, normally bound to the right mouse button,
is performed by calling the actions
_X_a_w_P_o_s_i_t_i_o_n_S_i_m_p_l_e_M_e_n_u(_M_e_n_u) and _M_e_n_u_P_o_p_u_p(_M_e_n_u). The _q_u_i_t()
Page 2 (printed 4/30/98)
XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111)))) XXXX11111111RRRR5555 ((((SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111))))
action, bound to the ``q'' and ``Q'' keys, is equivalent to
selecting ``Exit'' from the menu.
TTTTHHHHEEEE CCCCOOOONNNNTTTTRRRROOOOLLLL WWWWIIIINNNNDDDDOOOOWWWW
_X_p_o_s_t_i_t allows six operations to be performed from its
control window. Pressing the left mouse button in the
control window will cause all Post-it notes on the screen to
be raised to the top. Pressing the middle mouse button in
the control window will cause all Post-it notes on the
screen to be lowered to the bottom. Pressing the left mouse
button in the control window while holding down the CTRL key
will cause all notes to be mapped (shown). Pressing the
middle mouse button in the control window while holding down
the CTRL key will cause all notes on the screen to be
unmapped (hidden). Pressing the right mouse button in the
control window raises the _x_p_o_s_t_i_t menu. Pressing the ``q''
or ``Q'' keys in the control window will exit the program.
TTTTHHHHEEEE MMMMEEEENNNNUUUU
The _x_p_o_s_t_i_t menu provides the following selections:
CCCCrrrreeeeaaaatttteeee 1111....5555xxxx2222 NNNNooootttteeee
Create a new Post-it note, 1.5 inches tall by 2
inches wide. The window will normally need to be
positioned using the window manager.
CCCCrrrreeeeaaaatttteeee 2222xxxx3333 NNNNooootttteeee
Create a new Post-it note, 2 inches tall by 3 inches
wide.
CCCCrrrreeeeaaaatttteeee 3333xxxx3333 NNNNooootttteeee
Create a new Post-it note, 3 inches square.
CCCCrrrreeeeaaaatttteeee 3333xxxx4444 NNNNooootttteeee
Create a new Post-it note, 3 inches tall by 4 inches
wide.
CCCCrrrreeeeaaaatttteeee 3333xxxx5555 NNNNooootttteeee
Create a new Post-it note, 3 inches tall by 5 inches
wide.
CCCCrrrreeeeaaaatttteeee 4444xxxx6666 NNNNooootttteeee
Create a new Post-it note, 4 inches tall by 6 inches
wide.
RRRRaaaaiiiisssseeee AAAAllllllll NNNNooootttteeeessss
Raise all Post-it notes to the top. This is
equivalent to pressing the left mouse button in the
control window.
LLLLoooowwwweeeerrrr AAAAllllllll NNNNooootttteeeessss
Lower all Post-it notes to the bottom. This is
Page 3 (printed 4/30/98)
XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111)))) XXXX11111111RRRR5555 ((((SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111))))
equivalent to pressing the middle mouse button in
the control window.
HHHHiiiiddddeeee AAAAllllllll NNNNooootttteeeessss
Unmap all Post-it notes, making them disappear from
the screen. This is equivalent to pressing the
middle mouse button in the control window while
holding down the CTRL key.
SSSShhhhoooowwww AAAAllllllll NNNNooootttteeeessss
Map all Post-it notes, making them reappear if they
were hidden. This is equivalent to pressing the
left mouse button in the control window while
holding down the CTRL key.
SSSSaaaavvvveeee AAAAllllllll NNNNooootttteeeessss
Save all Post-it notes to disk files in the save
directory.
EEEExxxxiiiitttt Exit _x_p_o_s_t_i_t . If the ----ssssvvvv command line option was
given, or the ssssaaaavvvveeeeNNNNooootttteeeessss resource is ttttrrrruuuueeee ,,,, all
Post-it notes will be saved to disk first.
To select an item from the menu, drag the mouse cursor to
that item and release the mouse button.
TTTTHHHHEEEE PPPPOOOOSSSSTTTT----IIIITTTT NNNNOOOOTTTTEEEE
Each Post-it note is made up of five parts (plus an optional
scroll bar): a text window where the text of the note is
stored, and four buttons labeled ``Save'', ``Erase'',
``Destroy'', and ``Title''.
The title of a Post-it note, which will be displayed by most
window managers in both a title bar and the icon name area,
is by default the string ``PostItNote #'' followed by a
small integer, the number of the note. The procedure for
changing this title to something more meaningful is
described below.
To enter text into a Post-it note, simply move the mouse
cursor into the text window and start typing. Since the
text window is actually a Text widget, all the Text widget
translations are accepted. Essentially, this means you can
use most of the EMACS control keys in the window.
Additionally, the various mouse buttons used for
manipulating the selections and cut buffer are understood.
After entering text in the Post-it note, you may wish to
save the note in a disk file. This way, if the machine goes
down, or if you exit _x_p_o_s_t_i_t, the Post-it note can be
restored when you restart _x_p_o_s_t_i_t. (Post-it notes are also
saved automatically (if ssssaaaavvvveeeeNNNNooootttteeeessss is true) if a SIGHUP,
Page 4 (printed 4/30/98)
XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111)))) XXXX11111111RRRR5555 ((((SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111))))
SIGINT, SIGTERM, or SIGQUIT signal is received.) To save
the note to a disk file, move the mouse cursor to the button
labeled ``Save'' and press the left mouse button. The note
will be saved as the file ``note_n'' in your save directory,
where _n is some sequence number. NNNNOOOOTTTTEEEE: it is important to
remember that until you have pressed the ``Save'' button,
the data stored in the Post-it note is not saved on disk and
can be lost if the system goes down or _x_p_o_s_t_i_t exits.
To erase the entire contents of the text window, you can
press the left mouse button in the ``Erase'' button. This
will bring up a confirmation window, which has two buttons
labeled ``Confirm'' and ``Cancel''. If you press the
``Confirm'' button, the text will be erased. If you press
the ``Cancel'' button, the operation is canceled, and
nothing will happen. NNNNOOOOTTTTEEEE: erasing the text in the window
does not affect any contents of the note you have saved on
disk unless you press the ``Save'' button again.
To destroy a Post-it note, getting rid of its window on the
screen and the disk file it is saved in, move the mouse
cursor to the ``Destroy'' button and press the left mouse
button. This will bring up a confirmation window as
described above. If you confirm the operation, the Post-it
note will disappear from the screen and the disk file it was
saved in will be deleted.
To change the title of a Post-it note, both in any title bar
on the window as well as in the icon for the note, move the
mouse cursor to the ``Title'' button and press the left
mouse button. This will bring up a dialog box with the
current title in it. Change or modify the title, and press
the ``Okay'' button with the mouse to change the title, or
press the ``Cancel'' button to discard the change.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
X(1)
BBBBUUUUGGGGSSSS
The sizes of the Post-it notes are only as accurate as the
display dimension and resolution returned by the server. On
the Sun server and possibly others, this means they aren't
all that accurate.
When the title of a Post-it note is changed, some window
managers (notably _t_w_m ) will not make the change in the icon
name, since they only look up this data when a window is
mapped. This can be ``fixed'' by unmapping all notes and
mapping them again.
Without a color display for canary yellow notes and red
plaid, the aesthetic value of _x_p_o_s_t_i_t cannot be fully
Page 5 (printed 4/30/98)
XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111)))) XXXX11111111RRRR5555 ((((SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) XXXXPPPPOOOOSSSSTTTTIIIITTTT((((1111))))
appreciated.
AAAAUUUUTTTTHHHHOOOORRRR
David A. Curry, Purdue University
``Post-it'' and the plaid design are registered trademarks
of 3M.
Page 6 (printed 4/30/98)